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Setting Up the Simulator - Java 


■ IBM JDK1.1.8 must be installed to use the 
Simulator 



■ If you do not have JDK1.1.8 installed, the 
installation EXE is located on the SureVision 
Demo CD 



■ Install JDK1.1.8 onto ): with the defaults 


Retail Store Solutions 


JDK1.1.8 must be installed to use the Simulator 

If you do not have JDK1.1.8 installed, the installation EXE is located on the SureVision Demo CD 
Install JDK1.1.8 onto C: with the defaults 
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Setting Up the Simulator 


■ Copy the \Simulator directory files from the 
SureVision Demo CD into the 

C:\SureVision\Simulatordirectory 



► swing.jar 

► javapos.zip 

► jattach.jar 

► ib5core.jar 

► ib5crypt.jar 

► ib5extra.jar 

► ib5http.jar 

► ib5https.jar 


► ib5js.jar 

► ib5ref.jar 

► ib5ri.jar 

► ib5swing.jar 

► ib5util.jar 

► ib5ib4.jar 

► iscl.jar 

► sim.jar 
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Copy the \Simulator directory files from the SureVision Demo CD into the C:\SureVision directory (files are now in 
C:\SureVision\Simulator directory) 


• swing.jar 

• javapos.zip 

• jattach.jar 

• ib5core.jar 

• ib5crypt.jar 

• ib5extra.jar 

• ib5http.jar 

• ib5https.jar 

• ib5js.jar 

• ib5ref.jar 

• ib5ri.jar 

• ib5swing.jar 

• ib5util.jar 

• ib5ib4.jar 

• iscl.jar 

• sim.jar 


Java Swing file 
4690 OS file 
4690 OS file 
ICE 5 browser file 
ICE 5 browser file 
ICE 5 browser file 
ICE 5 browser file 
ICE 5 browser file 

ICE 5 browser file 
ICE 5 browser file 
ICE 5 browser file 
ICE 5 browser file 

ICE 5 browser file 
ICE 5 browser file 
ICE 5 browser file 
Simulator file 
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Setting Up the Simulator... 



■ Copy the common SureVision files only from 
the \SVcommon directory on the SureVision 
Demo CD into the ‘>ureVision\Simulator 

directory 

► sureview.jar 

► xerces.jar 
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Copy the common SureVision files only from the \SVcommon directory on the SureVision Demo CD into the 
\SureVision\Simulator directory (files are now in C:\SureVision\Simulator directory) 

• sureview.jar SureVision file 

• xerces.jar XML parser file 

• The xerces.jar file is not on the SureVision installation diskettes in jar format. It is compressed into a .dat file to 
fit on the diskette. 
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Setting Up the Simulator... 


■ Copy the \SVsa directory on the SureVision 
Demo CD into the \SureVision\Simulator\SVsa 

directory. 



► svsa.jar 

► svuser.jar 

► ist.ist (EAMS@000) 

► runsa.bat 

► sim.inp 

► jiop.pro (equivalent to j.pro on 4690 OS) 
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Copy the entire directory into \SureVision\Simulator (files are now in C:\SureVision\Simulator\SVsa directory) 


svsa.jar 

svuser.jar 

ist.ist 

runsa.bat 

sim.inp 

jiop.pro 


SureVision application-specific file for SA 
SureVision user file for SA 
Application input state table for SA (EAMS@000) 
Batch file for starting the simulator 
Simulator input file for SA 
Java properties file 


• The svsa.jar file (or svgsa.jar or svcdsa.jar) is not on the SureVision installation diskettes in jar format. It is 
compressed into a .dat file to allow the installation batch file to be the same for each SureVision application 
installation. 

• The svuser.jar file is not on the installation diskettes. It is on the SureVision Installation CD under the 
\Extentions directory. This was done to prevent customers from overriding an existing svuser.jar file. 

• This ist.ist file is the same as the 4690 input state table. If yours is different from the base application, use it 
instead. The ist.ist file must be the input state table of the application you are simulating. 

► SA input state table - EAMS@000 

► GSA input state table - EALT@000 

► CDSA input state table - EGHS@000 

• The sim.inp file simulates input state changes for SureVision. The sim.inp file provides a sequence of states to 
the Simulator. 

• The states in the sim.input file must be matched to the available states in the ist.ist file. The sim.inp points to 
the ist.ist file that it uses. 

• The Java properties file, jiop.pro is the equivalent to the j.pro file on 4690 OS. The JlOP.pro file points to the 
sim.inp file. 
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The sim.inp file simulates input state changes for SureVision. The sim.inp file provides a sequence of states to 
the Simulator. 

The states in the sim.input file must be matched to the available states in the ist.ist file. 

Note that this file points to the ist.ist file which is located in c:\SureVision\Simulator\svsa. If you did not use the 
directories specified, edit the sim.inp and change the directory of the ist.ist file to point to the correct path . See 
GREEN. 

Since Supermarket application has only a few states, substates have been added. In the initial version of 
SureVision these states are triggered by "guessing" the state via "screen scraping". An efix or csd will be made 
for both SA and SureVision. The new substates will be integrated into SA and changes will be made to 
SureVision to trigger off the new substates. If you design your SureVision screens to trigger off the states or 
substates, the efix/csd should be transparent to your changes. You will have to relink your Supermarket 
application to pick you the new substates. 

Note that the substates are actually POS application data. Therefore, "tight coupling" must be used (you will 
need to relink your application to pick up the SureVision calls for the application data). 

This shows the states and substates that the application will follow in the simulator. States are shown in BLUE. 
Substates are shown in RED. 

The data is not checked for accuracy. 

Note the path of the ist.ist file. If you did not install the Simulator in the directory path given in the directions, 
then you need to edit this line to point to the ist.ist file. 















runsa.bat 
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java -nojit -classpath 
c:\Surevision\SAsvuser\; 
c:\SureVision\Simulator\jattach.jar; 
c:\SureVision\Simulator\sim.jar; 
c:\SureVision\Simulator\SVsa\svuser.jar; 
c : \SureVision\Simulator\SVsa\svsa . jar; “ic 

c:\SureVision\Simulator\Sureview.jar; 



c:\SureVision\Simulator\swing.jar; 
c:\SureVision\Simulator\javapos.zip; 
c:\SureVision\Simulator\ib5core.jar; 
c:\SureVision\Simulator\ib5util.jar; 
c:\SureVision\Simulator\ib5js.jar; 
c:\SureVision\Simulator\ib5ref.jar; 
c:\SureVision\Simulator\ib5http.jar; 
c:\SureVision\Simulator\ib5extra.jar; 
c:\SureVision\Simulator\ib5swing.jar; 
c:\SureVision\Simulator\ib5ri.jar; 
c:\SureVision\Simulator\iscl.jar; 
c:\SureVision\Simulator\iceib4.jar; 
c:\SureVision\Simulator\xerces.jar; 

-DGUI.debug=gui.out 
-DJIOP.NoDev=TRUE 

-Dprops=c:\SureVision\Simulator\SVsa\JIOP.pro com.ibm.sureview.sa.Main 
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• runsa.bat (or rungsa.bat or runcdsa.bat) startst the Simulator 

• Note that all the files in the classpath except for the application-specific files (and classes.zip) point to 
c:\Surevision\Simulator. If you did not install the Simulator in the directory path given in the directions, then you 
need to edit this file to point to the correct path. 

• ASTERISKS: Note that application specific files are in the application-specific directory. 

• In RED: SAsvuser in other batch files is GSAsvuser or CDSAsvuser path 

• In RED: Note that the \Surevision\SAsvuser\ path is before the d:\Surevision\Simulator\SVsa\svuser.jar file. 

This allows you to pick up any changes you have made in the expanded svuser.jar file directory. 

• In GREEN: svsa.jar in other batch files is svgsa.jar or svcdsa.jar 

• In CYAN note that JDK1.1.8 must be installed. If you did not install JDK1.1.8 in the path specified, edit runsa.bat 
and change these lines to point to the correct path. 

• In ORANGE: xerces.jar must be last in the classpath for the browser to work properly 

• -DGUI.debug=gui.out sets the debug output file if debug is on (in jiop.pro) 

• -DJIOP.NoDev=TRUE indicates there are no devices 

• -Dprops=c:\SureVision\Simulator\JIOP.pro com.ibm.sureview.sa.Main runs the Supermarket Application 
SureVision. The other batch files have the GSA or CDSA Main (...gsa.Main or ...cdsa.Main) 
















(© Hints and Tips 
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■ If you are not running the SureVision 
Simulator from the drive, edit and change 
the paths in: 

► sim.inp 
►jiop.pro 

► runsa.bat 

■ If IBM JDK1.1.8 is not installed on the C: 
drive, edit and change the path in runsa.bat 

■ If the Simulator runs, but you do not get XML 
changes, you may have a back-level of JDK. 
Use the one on the SureVision Demo CD. 
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If you are n&t running the SureVision Simulator from the C: drive, edit and change the paths in: 

► sim.inp 

appLoadlnputStateTable c:\SureVision\Simulator\svsa\IST.IST @ appOpen 

► jiop.pro 

MAPPATH=c:\\SureVision\\simulator\\ftn.map 

SIMINPATH=c:\\SureVision\\simulator\\svsa\\sim.inp 

SIMOUTPATH=c:\\SureVision\\simulator\\sim.out 

JIOP.debug=c:\\SureVision\\simulator\\jiop.out 

#GUI.debug=c:\\com\\ibm\\sureview\\util\\gui.out 

► runsa.bat 

change all c: to your drive letter 

If IBM JDK1.1.8 is not installed on the C: drive, edit and change the path in runsa.bat 

c:\jdk1.1,8\bin\java -nojit -classpath c:\Surevision\SAsvuser\; ... 
and 

... c:\JDK1.1.8\lib\classes.zip; ... 

If the Simulator runs, but you do not get XML changes, you may have a back-level of JDK. Use the one on the 
SureVision Demo CD. 
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Simulator Directory Path Tree 


C:SureVision—| 

-Simulator-1 

| swing.jar 

| javapos.zip 

| jattach.jar 

| ib5core.jar 

| ib5crypt.jar 

| ib5extra.jar 

| ib5http.jar 

| ib5https.jar 

| ib5js.jar 

| ib5ref.jar 

| ib5ri.jar 

| ib5swing.jar 

| ib5util.jar 

| ib5ib4.jar 

| iscl.jar 

| sim.jar 

| sureview.jar 

| xerces.jar 

| -svsa- 

I I 

I I 

I I 

I I 

I I 

I I 

| +svgsa 

| +svcdsa 

iSAsvuser 
+GSAsvuser 
+CDSAsvuser 


I 

svuser.jar 
svsa.jar 
ist.ist 
sim.inp 
jiop.pro 
runsa.bat 


Retail Store Solutions 


When installed the Simulator directory tree should look like this directory tree. 
The + indicates a directory with files that is not expanded 
The - indicates a directory with files that is expanded 
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Running the Simulator 



■ To run the Simulator: 

► Open a DOS window 

► Change to C:\SureVision\Simulator\SVsa 

► Run the batch file: runsa.bat 

■ Be sure that the input state table file, ist.ist, 
and simulator input file, sim.inp match the 
application you are running. 

■To stop the Simulator: CTRL+C in the DOS 
window 
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Run the Simulator, by executing the applicable batch file (runsa.bat, rungsa.bat, or runcdsa.bat) from the 
D:\SureVision\Simulator application-specific directory in a DOS window 

It is very important that the input state table file, ist.ist, and the simulator input file, sim.inp match the batch file 
that is running. 

To stop the Simulator, press CTRL+C in the DOS window. This allows you to easily rerun the Simulator by 
using the up-arrow key to recall the batch file. 
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Java I/O Processor Properties File - 
jiop.pro 



#Java I/O Processor Configuration Settings 

#Tue Jul 07 14:33:12 EDT 1998 

MAPPATH=c:\\SureVision\\simulator\\ftn.map 

SIMINPATH=c: \\SureVision\\simulator\\svsa\\sim. inp 

SIMOUTPATH=c:\\SureVision\\simulator\\sim.out 

JIOP.NoDev=TRUE 

JIOP.debug=c:\\SureVision\\simulator\\jiop.out 
#GUI.debug=c:\\com\\ibm\\sureview\\util\\gui.out 


Note: This file is equivalent to the j.pro file on 
the 4690 OS. 
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The Java I/O processor properties file, jiop.pro, also contains some paths. If you did not install the Simulator in 
the directory path given in the directions, then you need to edit the paths to point to your directory. 

In RED: Note that sim.inp is in the application-specific directory. 

To run the GUI debugger, uncomment the line: #GUI.debug=d:\\com\\ibm\\sureview\\util\\gui.out by removing 
the # sign. 

The jiop.pro file is equivalent to the j.pro file on 4690 OS. The name was shortened on 4690 OS to conserve 
space. 


EVERYONE SHOULD TEST THEIR SIMULATOR AT THIS POINT. 
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Java I/O Processor Properties File 


■ j.pro on the terminal and jiop.pro on the 
simulator 



■ Text file containing keyword - value pairs used 
to pass configuration options to SureVision at 
startup. 

► Options effecting JIOP tracing 

► Options defining which XML files to load for 
specific registers or groups of registers. 
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A command line properties file (j.pro on the terminal and jiop.pro on the simulator) is a text file containing 
keyword - value pairs, which is used to pass configuration options to SureVision upon startup. 

Among the values that may be placed in the file are options effecting JIOP tracing, and options defining which 
XML files to load for specific registers or groups of registers. 
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SureVision Load Window 
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As SureVision is loading in the Simulator (or on 4690 OS) a window displays indicating the PRPQ number, the 
build version, the build date, and the build time. 

This is useful when upgrading your system to be sure you are running the correct level of SureVision. 
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Supermarket Application Simulator 
Screen 


Scan or enter the next item 
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Register: 99 
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Supermarket Application base item entry base screen 
This is the screen after signon 
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svuser.jar - Common Files 



■ Different for each application 

■ Not installed by the installation diskettes 

■ Available on the SureVision installation CD 

■ Contains SureVision XML files 

■ Common files: 


► defcolor.xml 

► defcomp.xml 

► 640X480.xml 

► 800X600.xml 

► 1024X768.xml 


► 640X480-example-screen.xml 

► 800X600-example-screen.xml 

► 1024X768-example-screen 

► 800x600FiftyKeyScreen.xml 

► user.xml 
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There is a different svuser.jar file for each of the applications. Some of the files are common to each jar, but 
some are unique to the application. 

The svuser.jar file is NOT installed by the installation disks. This was done so as not to overwrite an existing 
svuser.jar. The svuser.jar files are located on the SureVision installation CD. 

The XML files are all contained in the svuser.jar files. The common default XML files are: 


defcolor.xml 
defcomp.xml 
640X480.xml 
800X600.xml 
1024X768.xml 

640X480-example-screen.xml 
800X600-example-screen.xml 
1024X768-example-screen 
800x600FiftyKeyScreen.xml 
user.xml 


SureVision default color schemes 

SureVision default common components 
SureVision 640X480 screen default fonts 
SureVision 800X600 screen default fonts 
SureVision 1024X768 screen default fonts 
Fully configurable item entry 640X480 screen 
Fully configurable item entry 800X600 screen 

Fully configurable item entry 1024X768 screen 
Fully configurable 50-key keyboard screen 
File for making user changes 


Note: On the original SureVision Installation CD, the GSA svuser.jar file does not contain most of the common 
files. This is a bug. 
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svuser.jar - Application-Specific Files 



■ Supermarket Application XML files: 

► sasvOOO.xml 

► satrigs.xml 

► statetrg.xml 

■ General Sales Application XML files: 

► gsasvOOO.xml 

► gsatrigs.xml 

■ Chain Drug Sales Application XML files: 

► cdsasvOOO.xml 

► cdsatrigs.xml 
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The remaining files in the svuser.jar are application-specific. 

The Supermarket Application XML files are: 

► sasvOOO.xml Supermarket Application/ACE GUI layout 

► satrigs.xml Supermarket Application loose coupling (SA only, not ACE) 

► statetrg.xml Supermarket Application/ACE base screens and trigger actions 

The General Sales Application XML files are: 

► gsasvOOO.xml General Sales Application GUI layout 

► gsatrigs.xml General Sales Application base screens and trigger actions 

The Chain Drug Sales Application XML files are: 

► cdsasvOOO.xml Chain Drug Sales Application GUI layout 

► cdsatrigs.xml Chain Drug Sales Application base screens and trigger actions 

The xxxsvOOO.XML is the default XML file. To have a XML file for a specific terminal copy this file and change 
the 000 to the terminal number. 
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Extracting svuser.jar for the Simulator 


IBM Java 1.1.8 must be installed 



■ To extract svuser.jar file: 

► Create extracted svuser.jar directory: 
— ForGSA: GSAsvuser 

— For SA: SAsvuser 
— ForCDSA: CDSAsvuser 

► Copy svuser.jar to the new directory 

► Extract files: jar -xvf svuser.jar 

► Erase svuser.jar 

► Erase the directory \META-INF 


Retail Store Solutions 


All changes to SureVision are done in the svuser.jar file. Specifically, changes are made in the user.xml file. 
The Simulator allows you to test these changes without having to "rejar" the svuser.jar file. To expand the 
svuser.jar, Java 1.1.8 must be installed on your computer. Java 1.1.8 is available on the SureVision Demo CD 
under the directory, \JDK 1.1.8. 

Create the extracted svuser.jar directory: 

► ForGSA: GSAsvuser 

► ForSA: SAsvuser 

► ForCDSA: CDSAsvuser 

Extract the files: jar-xvf svuser.jar (needs Java 1.1.8 for this step) 

Erase svuser.jar to run from the extracted files 

Erase the \Meta-lnf directory to keep it from appearing in the jar file when you rebuild svuer.jar. 

You can use the SureVision Simulator with the new extracted svuser.jar directory. The Simulator uses the 
expanded jar file because the path in the batch file looks at the expanded jar file directory path (GSAsvuser, 
SAsvuser, or CDSAsvuser) before the Simulator directory path. 

To use the Simulator, change to the \SureVision\Simulator and execute the batch: 

► ForGSA: rungsa.bat 

► ForSA: runsa.bat 

► ForCDSA: runcdsa.bat 

EVERYONE SHOULD TEST THEIR SIMULATOR AT THIS POINT. 
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Creating a New svuser.jar 


IBM Java 1.1.8 must be installed 



■ To extract svuser.jar file: 

► Change to the extracted svuser.jar directory: 
— ForGSA: GSAsvuser 

— For SA: SAsvuser 
— ForCDSA: CDSAsvuser 

► Create the jar: jar -cvf svuser.jar*.* 

■ Use the new svuser.jar file on 4690 OS 
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Once you have made the changes to your expanded svuser.jar using the user.xml file, you need to "rejar" the 
svuser.jar for use with the 4690 OS. To create the new svuser.jar, Java 1.1.8 must be installed on your 
computer. Java 1.1.8 is available on the SureVision Demo CD under the directory, \JDK 1.1.8. 

Change to the extracted svuser.jar directory: 

► For GSA: GSAsvuser 

► ForSA: SAsvuser 

► For CDSA: CDSAsvuser 

"Rejar'VCreate the new svuser.jar file: jar -cvf svuser.jar 
Use the new file on the 4690 OS. 
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user.xml 



■ Editing 

► Text edit - notepad, wordpad, etc. 

► XML editor -XMLSpy 

■ Making changes to user.xml: 

► Copy and paste entries from the existing 
XML files 

► Text edit and build the elements 

► Use XMLSpy to add a child to the jgui-root 

■ Using cut and paste gives you an example to 
follow 
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To make changes to the SureVision screens use the user.xml file. 

The user.xml file is contained in the svuser.jar. 

Remember, the svuser.jar file is NOT installed by the installation disks. This was done so as not to overwrite an 
existing svuser.jar. The svuser.jar files are located on the SureVision installation CD or the SureVision Demo 
CD. 

Edit the user.xml file via: 

► Any text editor 

► XML editor of your choice 

► Development used XMLSpy. This is what we are using for class. Go to www.xmlpy.com for a 30-day free 
evaluation copy. 

There are several ways to add your changes to the user.xml file. 

► Copy and paste entries from the existing XML files 

► Editing and build with a text editor 

► Use the XML editor to add a child to the igui-root. 

It is often easier to use the cut and paste method since it gives you an example to follow. 
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Zi XML 

0" Comment 

edited with XML Spy v4.3 (http:.'/www .xmlspy.com) by Sharon Graves (IBM Corporation) 

{!" Comment 

********* * ******************** ************ ******************* 

{!■■ Comment 

COPYRIGHT: 

{!■■ Comment 

LICENSED MATERIALS - PROPERTY OF IBM 

{!*■ Comment 

"RESTRICTED MATERIALS OF IBM" 

0" Comment 

5799-RQQ 

Comment 

(C) COPYRIGHT IBM CORP. 2000 

{!■■ Comment 

* +.+. + *.+ ******** * * *.+ + * * * *.+. * + * ****** * * +. * + * * *.+ ******** * * *.+ + * ***** 

{!•* Comment 

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 

{!■■ Comment 

*** SureVision User Configuration File *** 

{!■■ Comment 

************************************************************* 

A. 

jgui-roat 



= xmlns 

http: //www .ibm .com.'Sure Vision 

= xmlns:xsv 

http: //www. w3 .org/2001 /XMLSchema-instance 

— xsi.-schemaLocation 

http: //www .ibm .com/Sure 1 Vision 
sureview.xsd 
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This is the XML Spy Enhanced Grid View of the user.xml file with igui-root expanded 
Making changes: 

► Add changes directly to user.xml 

► Create changes in a new XML file and include that file in user.xml. 
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Updating Jar Files 


On the controller: 



■ Stop the Java and Terminal applications: 

► Access the Store Control Functions Screen 
- [Alt + SysRq+C] 

► Terminal Functions 

-Java Application Functions 
• Stop Java Application 

-Stop Terminal Application 

■ Copy the jar files to ADXJPGM 

► CHKDSK -F on the jar files 
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If you wish to update the jar files without using Applied Software Maintenance, use the following steps: 

• From the controller, stop the Java application: 

► Access the Store Control Functions Screen - [Alt + SysRq+C] 

► Terminal Functions - [1] [Enter] 

► Java Application Functions - [6] [Enter] 

► Stop the Java Application - [3] [Enter] 

► Type the Terminal Number - [terminal number] [Enter] 

• Stop the Terminal application: 

► From the Terminal Functions, select Stop Terminal Application - [5] [Enter] 

► Type the Terminal Number - [terminal number] [Enter] 

• Copy the jar files to ADXJPGM. 

► Note: Normally you will only copy over the svuser.jar file. This is the file that contains any user changes. The 
other jar files should remain unchanged. 

► Note: When copy files from the Simulator, you need to run the 4690 command, CHKDSK -F on the jar file to 
fix the error "The file record size does not match your request. The file you are attempting to use may be 
corrupted or contains an invalid format." when trying to copy the file. 














Updating Jar Files... 
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Restart the Java and Terminal applications: 
► Terminal Functions 
-Java Application Functions 
• Start Java Application 
For Controller/Terminal: 


♦ GSA: 

♦ SA: 

♦ CDSA: 


-Dprops=c:\j.pro 
-Dprops=c:\j.pro 
-Dprops=c:\j.pro 


com.ibm.sureview.gsa.Main 
com.ibm.sureview.sa.Main 
com.ibm.sureview.cdsa.Main 


For Terminal: 


♦-Dprops=R::c:\j.pro com.ibm.OS4690.TOF.TOFStartApp sureview 

♦ Run TOF.BAT in ADX IPGM 


-Start Terminal application 
• Type \ for default 
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Restart the Java application: 

► From the Terminal Functions, select Java Application Functions - [6] [Enter] 

► Start the Java Application - [2] [Enter] 

-Type the Terminal Number - [terminal number] [Tab] 

-Type the Class and Parameters: 

For Controller/Terminal: 

■ For GSA: -Dprops=c:\j.pro com.ibm.sureview.gsa.Main 

■ For SA: -Dprops=c:\j.pro com.ibm.sureview.sa.Main 

■ For CDSA: -Dprops=c:\j.pro com.ibm.sureview.cdsa.Main 
For Terminal: 

■ -Dprops=R::c:\j.pro com.ibm.OS4690.TOF.TOFStartApp sureview.pro 

■ Run TOF.BAT in ADX_IPGM to create the files the terminal needs to load. 

Note: Failure to do this step will cause the terminal to load on an old level of SureVision or not load at 
all. 

Start the Terminal application: 

► From the Terminal Functions, select Start Terminal Application - [4] [Enter] 

-Type the Terminal Number - [terminal number] [Tab] 

-Type the Application Name - [\] [Enter] (for default) 














